home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Ham Radio 2000
/
Ham Radio 2000.iso
/
ham2000
/
bbs
/
aut7p130
/
auto7pen.doc
< prev
next >
Wrap
Text File
|
1993-03-22
|
27KB
|
889 lines
1
AUTO7P v1.30
FBB server compatible with 7plus 2.02 (1.63)
(c) IK1GKJ@IW1BRX.ITA.EU.
7PLUS routine by DG1BBQ@DB0CL
THIS SERVER IS NOT COMPATIBLE WITH 7PSERV OF SM0NCS
===================================================
Again: sorry my bad Eglish.
UPDATED
=======
Version 1.0 Beta test named 7PSERV
Version 1.10
From the bulletin in circulation, i have noted that SM0NCS is
very furious for the fact that i have called this server whit the
same name of his server. I have changed the name, i hope that now
he do not have other problem. Again i will specify, like is write
in the documnation of my server, that the name 7pserv , of the
previus version, was not to steal the 'royaltes' of SM0NCS, but
only to remember the server and 7plus.
Now you can redirect the output of the server also for the
.cor correction file. (sysop only)
You can recall also a single part of a files or .cor file, if
this is better of the recall the global file.
AUTO7P v1.30 2
The import file, MAIL.IN, now must be split in more parts, you
can decide the size. The same server provide to recompose
MAIL.IN
The same server, can be inserted in the cron.sys file, and can
extract from all the bullettin that you have receive on your bbs
all the 7+ file, recompose it, and request correction for errors.
The user can not use the server to download files, they can
upload data, .err, .cor, but to download files they must be enable
by sysop.
The return path is now read directly trought FBB path.
Version 1.20
Speed up extraction module routine, now is 3 time more faster.
Correct return path extraction routine, now accept some non
standard format.
Added program M_FILTER, to extract only 7plus code from mail,
this is an alternative form of the forward file, and may speed up
bbs activity.
Added the variable 7PMANAGER, to specify a manager callsign.
If found, the server send its message to this callsign, else the
sysop message are send to the bbs callsign.
Version 1.21
If the user write anythin in the title of the message over the
title of the file, the file name was not properly decoded. Fixed.
If a 7plus code arrived truncated on the bbs, when auto7p
attempt to decode, it stop and send out a "write error on
metafile" message to the sysop; the metafile was deleted. Now the
metafile is not deleted, and also if the reconstruction of the
original file is not sure, a correction file is requested.
Version 1.22
In the previusly version, when extract a file with the option
INQUIRYFILE, if the filename in the 7plus header was length 12
bytes, the program lose the sender of the messages. Fixed.
AUTO7P v1.30 3
Version 1.30
To remove any possibility or conflict with future expansion of
the FBB program, i have added a configuration file, AUTO7P.cfg, so
the server do not need to read any fbb files. Adding the DELETIME
options, to remove the oldest file from the \AUTO7P directory.
Adding the possibility to enable any user to download files, (only
for his callsign); see the auto7p.cfg descriptions for more
detail. Adding the possibility to move the successfully converted
files to a separate directory. No more needed the enviroment
variable 7PMANAGER and 7PMAXMAIL, this is defined in the
configuration file. The server now do not read the init.srv and
inf.sys file, this speed up the execution.
AUTO7P v1.30 4
INSTALLATION
============
Copy the file AUTO7P.EXE in the directory where is INIT.SRV.
Next, at the end of the file INIT.SRV, insert between the two line
'-------------' this row:
---------------------------
AUTO7P AUTO7P Automatic encoding/decoding 7plus files
---------------------------
THANKS
======
I will thanks DG1BBQ that have developed the source code of 7PLUS
v 2.02 for the excellent work, since this server use hes routines
for decode and encode files.
AUTO7P v1.30 5
FEATURES
========
* Output file to user, split if needed in about 6 Kb.
* Automatic output of correction file when an .err file is
received.
* Automatic output of .err file if any errors is encounterd
while decoding the 7+ file.
* After a correct decoding of data, if no errors encounterd, the
server erase all the not needed file, and advise the sysop that a
new file is present.
* If this exchange of data is between to bbs that use this
server, all the operations are automatics.
* Again the server advise the sysop if a serious error require
his personal operation.
* All the files are store in the directory \AUTO7P in the root
of the disk, so only the sysop can manipulate its contents.
* Is possible move the succesfully decoded file to a separate
directory.
* You can redirect the output of a the server for files and
.cor, so you can send it like SP/SB to any destination@bbs. This
option is only for those calls enabled in the auto7p.cfg file, and
work only for data and .cor files. (Is a non-sense send out a .ERR
file to IBM@WW !).
* You can recall a single split part of the file, or .cor, when
this is better than the entire block of data.
* You can redirect a message to the server with the command SC
od FBB, the server provide to extract the corret start call and
the return path, so if a user send to you a .cor file insted of
the serve, you can redirect it. (Enabled user only).
* The MAIL.IN file can be splitted in more parts, you choose the
size. In this case the server provide to recompose it every hours.
AUTO7P v1.30 6
* If you insert the server also in the cron.sys, you can extract
from a forward file all the 7plus file, recompose it, and request
a correction file if an error is encountered.
* The user can download the file only if the sysop enable his
callsingn, or if the global download flag is set: in this case,
the callsign may be excluded.
* The server may deleted any files in the \AUTO7P directory that
have a date oldest of the specified numbers of day.
* If the user attempt to download a file, and he is not enable,
he receive a message with the prayer to call the sysop to obtain
authorization, and the sysop is advised, so he can decide if
enable this user to download file.
* For last, the server return an error code to FBB if any serius
error occurs and it is unable to operate. FBB will provide to
advise the sysop of the malfunction.
This is all the possible server error:
+ Unable to open or write MAIL.IN file.
+ Insufficient memory to run.
+ The server was not called in the corret mode.
+ Unable to open or read the file passed like argument from FBB,
or the format for this file is unknown.
+ Unable to open or read AUTO7P.CFG file.
+ Unable to access and create \AUTO7P directory.
+ Unable to access and create (if setup), the converted file
directory
AUTO7P v1.30 7
THE CONFIGURATION FILE AUTO7P.CFG
=================================
In this file is specified all is needed to the server for his
configuration. This is a very simple file:
Every line that start with the '#' symbol, like the FBB style,
is a comment and ingnored. The first seven valid line, are the
enviroment configuration for the server, and must be all defined.
The other, form eight to XXXX, are optional, and are the callsign
authorizations flags.
Here the list and documentation about the first seven lines:
Parameter 1, is the callsign of the BBS, whitout the SSID; you
may put, for example, IK1GKJ, but not IK1GKJ-8
Parameter 2, base directory for the server. When you split a
program to send out, this is the directory where the server start
the search. For example, if you put C:\YAPP\, (DO NOT FORGET THE
'\' AT THE END), and you want send the BIN\TTT.EXE programs, the
server transform your command in C:\YAPP\BIN\TTT.EXE. This
parameters usually is the \USERS\YAPP directory.
Parameter 3, the path and name of the import file of the bbs,
for FBB, the MAIL.IN file. Must be the same that you have declared
in your INIT.SRV file.
Parameter 4, is the directory where the server move and store
the successfully decoded files. If you do not want move the files,
put the \AUTO7P\ statement, and the programs remain in the auto7p
directory. If the specified directory do not exist, the server
provide to create it. Again, DO NOT FORGET THE '\' AT THE END OF
THE PATH. Any drive my be set, but floppy disk is not recomended,
since the server do not trap the dos INT23 critical handler, and
if the disk is full, or not found, the program my be stopper.
(Retry, Abort, Fail DOS request.)
Parameter 5, redirection calssign for the message of the
server to the sysop, and ex 7PMANAGER enviroment variable. Is
possible, for a group of OM, that the callsign of the sysop that
manage the software is not the same of the bbs callsign. Setup
here this callsign. If the callsign is the same, duplicate here
the BBS callsign.
Parameter 6, Max lenght before split for the MAIL.IN file, and
ex 7PMAXMAIL enviroment variable. This value, in Kbytes, set the
maximum lenght for the import file. The next part of the splitted
AUTO7P v1.30 8
file is stored in temp. files, and recomposed by the server every
hours. This save the forward net from large input of data that may
rallenty the other message to forward. The range of this variable
is from 20 to 1000 KBytes, any value out of this range or equal to
0, disable the split option, and all the spitted data will be
imported to the bbs in a signle block. I have tested this
possibility with a single block of 800Kbytes, and no errors was
detected. IS NOT A GOOD IDEA DO A SINGLE BLOCK OF IMPORT, 50-70 is
a right value.
Parameter 7, global authorization to download files. If you
set this field to 0, only the users set up in the (optional) next
lines with a flags of 1 or 2 may request a download. The other
users may only request a correction files or upload programs.
If you set this field to 1, all the user may request a download,
but not the user with a flags of 0: this users may only upload
data and request a correction file.
Please note that this field only enable the personal download,
for example if a users needed of a .EXE file but do not have a
YAPP compatibility program. The redirection option, send the
message to SB IBM @ EU for example, is only for the callsign set
with the flags = 2.
So next lines, must have this form: CALLSIGN FLAGS. The
callsign must be without SSID, it found, it will be ignored, and
the flag may assume this value:
0 the callsign may only upload and request corrections
1 the callsign may download data.
2 no restrictions apply, always full access.
For example:
IK1GKJ 2
IK1MSL 1
IK1XXX 0
If the parameters seven is set to 0, only IK1MSL may do a
download, and only for his callsign. IK1GKJ do not have any
restrictions, any other user may only request correction and
upload data, IK1XXX do not care in this case.
If the parameter seven is set to 1, any users may do a download,
personal to his callsign, IK1XXX may only request a correction and
upload files, IK1GKJ do not have any restriction, IK1MSL do not
care in this example.
AUTO7P v1.30 9
Here is an example of AUTO7P.CFG
# Callsign of the BBS
IK1GKJ
#
# Base directory for the server download
C:\FBB\USERS\YAPP\
#
# Path and name of the import file
C:\FBB\MAIL.IN
#
# Directory where move the converted files
C:\FBB\USERS\YAPP\7PLUS\
#
# Callsign where address the server sysop message
IK1GKJ
#
# Max lenght to split import file (in Kbytes)
50
#
# Global download enabled
0
#
# Callsign with special authorization
IK1GKJ 2
IK1MSL 2
IW1BRX 1
#
# End of the example.
AUTO7P v1.30 10
THE KEY WORDS
=============
AUTO7P TO SB/SP [DESTINATION] [[ @ BBS]]
---------
Application: output data files and .cor
[Users flag=2 only]
This variable, inserted in the text of the file, can force the
type of message, the destination and bbs fields. The parameters
between [] are optionally, bat the parameters must be inserted
sequentially. Normally AUTO7P use the type SP for the message, but
you can redirect it to SB. You can insert for example SB IBM, but
is incorret insert only IBM.
You can redirect to:
AUTO7P TO SB
AUTO7P TO SB DESTINATION
AUTO7P TO SB DESTINATION @ BBS
AUTO7P PART x
-------------
Application: send data .err files
[Data Users flag=1, correction all]
Whit this command, inserted in the text of the file, you can
request a specified part of a file. If, for example, you note that
a .err file contain to many error for a single part of the source
file, you can request again that part of the file, instead of the
correction file. Also if you receive multiple .cor file, and one
of them was lost, you can request this single lost part.
You can use AUTO7P PART and simultaneusly AUTO7P TO.
AUTO7P v1.30 11
AUTO7PCLOCK
-----------
Application: recompose the forward.
If you have specified a size to split the import file,
parameter six in the auto7p.cfg, you MUST add in the CRON.SYS this
statement:
X AUTO7P AUTO7PCLOCK
So, every hour, the FBB parogram call the auto7p, and the server
attempt to setup a new block of forward form the temp. files
previusly splitted.
INQUIRYFILE filename
--------------------
Application: extract and recompose 7+ files
Whit this command, the server extract from a disk forward
file, all the 7plus part, and when complete, attempt to decode. If
any errors was encounterd, a correction file was request to the
sender. To obtain this, is needed only few modify to the FBB
files:
In BBS.SYS, insert the name AUTO7P, in a free row.
before after
01 IK1MSL 01 IK1MSL
02 IW1BRX 02 IW1BRX
03 03 AUTO7P
04 04
In FORWARD.SYS, create a block of forward: the next example assume
that you want inquiry all bullettin, and the personal message to
SYSOP. The line ! B IK1GKJ, my bbs name, is needed to not obtain
double data, since if the 7plus is direct to AUTO7P@IK1GKJ is
already intercept from AUTO7P directly.
#
A AUTO7P
P @
! B IK1GKJ
B AUTO7P
F SYSOP
G *
C D:\FBB\AUTO7P.FWD
---------------
AUTO7P v1.30 12
Note that in this example, my forward file is called
D:\FBB\AUTO7P.FWD, so in the CRON.SYS insert his line:
X AUTO7P INQUIRYFILE D:\FBB\AUTO7P.FWD
This is all, again the server will advise the sysop when a file is
correctly decoded, and request a correction file to the sender if
the part is corrupted. You can insert in CRON.SYS whether
INQUIRYFILE or AUTO7PCLOCK command.
******************************************************************
READING THE INFO ABOUT THE PROGRAM M_FILTER FOR AN ALTERNATIVE AND
MORE EFFICENT USE OF THE AUTO7P INQUIRYFILE COMMAND.
******************************************************************
The extraction of 7plus data form forward file is locked to this
sample rule:
The message must not be a copy. If it is a copy, it will be
ignored, this to not obtain duplicate file.
From the forward file will be extract only the .7PL and .Pxx
file, this because .ERR file is not needed, and .COR because i do
not know if the corection file refer to the part that i have
receive, since my part may be ok.
If i already have this file, or i already have the decoded
file, the message is ignored.
When a file is correctly decoded, the sysop will be advised.
DELETIME day
------------
Application: Delete oldest files from \AUTO7P\
Use this option to delete oldest files from the \AUTO7P\
directory. Due to many cause, you may receive olny some parts of a
7plus file, or you may nevar receive the requested correction file
for a correpted program. Since this files is not completed, the
server nevar may recompose it! This cost space on your hard disk!
You may kill this files after a time that you retain just, for
example, after 30 days from the reception of the message.
AUTO7P v1.30 13
The DAY parameter, specify the time to live of your data in
the \auto7p directory, and must be passed in number of day. For
example, AUTO7P DELETIME 30, delete all files in the \auto7p
directory oldest of 30 days from the current data.
Use with care, a small epurmess value, may inhibite the
composition of the data. A right value, may be between 25 and 40.
To use this option, edit your APPEL.BAT file, and add this
statement just before or after the EPURMESS command:
AUTO7P DELETIME x
SC COMMAND OF FBB
-----------------
The server recognize the duplicate message, end from it extract
the original sender and path.
This option is useful for the sysop, and reserved only to the user
flag callsign set to 2, when a user send out, for example, a
correction file to the callsing of the sysop instead of AUTO7P.
You must only do
SC #msg AUTO7P
This option can work join with AUTO7P TO, so you can redirect the
ouput (may be useful? ).
AUTO7P v1.30 14
HOW TO USE THE SERVER
=====================
The parts in square brackets [] are optionally.
Please note that the start directory of the sever is always that
is defined in the AUTO7P.CFG file, This directory must not be
included in the part. You must include only the subsequend
directory.
The user , or other FBB, ask for a file
---------------------------------------
You may download file only if your callsign is setup in the
auto7p.cfg file to 1 or 2, or if the global download flag is set
to 1 and the is callsign is not set to 0.
If this condistions is not valid, the sysop will be advised
for the unauthorized request, and the user will receive a message
to contact the sysop for the abilitation.
SP AUTO7P [@ BBS ]
UTILITY\TEST.COM
[AUTO7P TO .....] (user flag=2 ONLY)
[AUTO7P PART ....]
/ex
The user, or other FBB, request a correction file.
--------------------------------------------------
This possibility is always enabled.
SP AUTO7P [@ BBS]
UTILITY\TEST.ERR
[AUTO7P PART .....]
[AUTO7P TO ......] (users flag=2 ONLY)
......
CONTENTS OF THE ERROR FILE
......
/EX
AUTO7P v1.30 15
The user, or other FBB send a correction file.
----------------------------------------------
This option is always enbled.
SP AUTO7P [@ BBS]
UTILITY\TEST.COR (or C01, C02 ....)
.....
CONTENTS OF THE CORRECTION FILE
.....
/EX
The user, or other FBB, upload a file.
--------------------------------------
This possibility is always enabled.
SP AUTO7P [@ BBS]
UTILITY\TEST.7PL or .P01,P02 etc.
......
CONTENTS OF THE FILE
......
/EX
You have surely noted that i have always written the path of the
source file: THIS IS THE ONLY WAY for AUTO7P to manage the
automatic file transfer. If you do not do this, the server can not
work properly.
ALWAYS SPECIFY THE SOURCE PATH.
Again remember that the path ALWAYS start under the directory
specified in the AUTO7P.CFG file.
If the exchage of data occur between two AUTO7P server, the return
path will be AUTO7P @ BBS.
AUTO7P v1.30 16
NOTE for SYSOP
--------------
Since this server have a different name from the previusly
beta test (7PSERV), if you have just send out data with the
previusly server, do not remove it from the list of the server,
but maintain it for a time that you judge sufficient to answer to
eventually error file tah you may receive; but form now use this
server for you work.
If you note any malfunction, or have any suggestion, please
send to IK1GKJ @ IW1BRX.
Best 73, Mario IK1GKJ@IW1BRX
NB: All 7plus routine conversion in the program is copyright of
DG1BBQ, i have extract them form the source code of 7plus 202,
modified where needed and construct a control interface for it.
So many thanks to Axel, DG1BBQ.
UPDATED ..........................................................1
INSTALLATION .....................................................4
THANKS ...........................................................4
FEATURES .........................................................5
THE CONFIGURATION FILE AUTO7P.CFG ................................7
THE KEY WORDS ...................................................10
AUTO7P TO SB/SP [DESTINATION] [[ @ BBS]] ....................10
AUTO7P PART x ...............................................10
AUTO7PCLOCK .................................................11
INQUIRYFILE filename ........................................11
DELETIME day ................................................12
SC COMMAND OF FBB ...........................................13
HOW TO USE THE SERVER ...........................................14
The user , or other FBB, ask for a file .....................14
The user, or other FBB, request a correction file. ..........14
The user, or other FBB send a correction file. ..............15
The user, or other FBB, upload a file. ......................15
NOTE for SYSOP ..................................................16